Welcome to the "ARA Scripting Addition"
© 1996 Guillaume Besse, Full Resource
eMail : guyom@fra.fr
Click here for english version, and
here for french version.
What is ARA ?
ARA stands for "Apple Remote Access". ARA is a software set that
enables a dialup connection
to maintain the AppleTalk network protocol. With ARA, you can mount a remote
server as if it
was local to your machine, or access whatever service is available on the
network you are connected
onto.
What is an OSAX ?
An OSAX is an Apple Scripting Extension, an piece of software that extends
the standard
AppleScript vocabulary.
What is a ShareWare ?
This piece of software is distributed as ShareWare. This means that if you
use it, you should send me FF100 or US$25. Then you will receive the latest
full version, and be notified each time a new release appears.
Guillaume Besse
15, rue Brown Sequard
75015 Paris
France
What is "ARA Osax" ?
The "ARA Osax" adds new commands to open, get information about,
and close ARA connections.
How do I install it ?
To install ARA Osax, you need a system (> 7.0) supporting AppleScript.
Just drag the
file "ARA Osax" to your system folder. It will be automatically
put in the Extensions folder.
New AppleScript commands
ara connect file string
[asynchronous boolean]
[tarification level integer] -- not yet implemented
Opens a connection using the file whose path is given as a direct parameter.
Set the asynchronous parameter to true to open the connection asynchronously,
and to false to open it using the ARA modal progress dialog.
ara connect string
[username string]
[password string]
[asynchronous boolean]
[compatibility version1/version2/version3/versionX] -- not yet
implemented
[tarification level integer] -- not yet implemented
Opens a connection using the specified username and password. If there is
no username specified, the connection is opened in guest mode. Set the asynchronous
parameter to true to open the connection asynchronously, and to false to
open it using the ARA modal progress dialog.
ara disconnect
[asynchronous boolean]
Closes the current connection. Set the asynchronous parameter to true to
close the connection asynchronously, and to false to close it using the
ARA modal progress dialog.
ara status
Result: integer
This call returns an integer describing the state of the connection.
ara error number
Result: integer
This call returns the number of the error which occured on the last call
of an ARA command.
ara error string
Result: string
This call returns the textual description of the error which occured on
the last call of an ARA command.
ara user name
Result: string
This call returns the username with which the current connection was opened.
ara server name
Result: string
This call returns the name of the ARA server to which you are currently
connected.
ara message
Result: string
This call returns the message describing the current connection status,
like "Connected at 14400 bauds".
ara is answering
Result: boolean
True if we are currently answering an incoming call.
ara is calling
Result: boolean
True if we are currently calling a remote ARA server.
ara is aborting
Result: boolean
True if we are aborting a connection attempt, a running connection, or an
incoming call process.
ara is connected
Result: boolean
True if we are currently connected to a remote computer via ARA.
ara is disconnecting
Result: boolean
True if we are currently disconnecting from a remote computer.
ara is guest
Result: boolean
True if the current outgoing connection is made in guest mode.
ara connection is v2
Result: boolean
True if thje current connection is using the version 2 of the ARA protocol.
ara is notifying
Result: boolean
True if we are notifying the user that a current connection is running.
ara connection is multinode
Result: boolean
True if the ARA connection allows access to other computers on the server's
network.
ara connection time
Result: integer
Returns the numbers of seconds since the connection started. Negative if
there is no connection running.
ara time left
Result: integer
Returns the number of seconds remaining before the remote server closes
the connection. Negative if there is no connection running.
ara is client only
Result: boolean
True if the ARA software currently installed on this machine is for client
only. False if this is a server.
ara is multiport server
Result: boolean
True if the ARA software currently installed on this machine is a multiport
server, accepting several connections at the same time.
ara is version 2
Result: boolean
True if the ARA software currently installed on this machine is version
2.
ara is version 3 -- not yet implemented
Result: boolean
ara osax version
Result: string
Returns the version of this OSAX.
ara osax help
Result: string
Returns the help text about this OSAX.
ara shareware info
Result: string
Returns shareware information about this OSAX: registering, etc.
Distribution
This software is not in the public domain; rather it is Copyright ©1996
by Guillaume Besse. You may freely copy and distribute this software, provided
that it you do not charge for it. This software may be included in any disk
or CD-ROM library of public domain and shareware software sold by a NON-PROFIT
organization. This software may not be included in any commercial software
collection sold for profit, nor may it be bundled with any commercial software,
hardware, books, or other media without the prior written consent of the
author. Whenever it is distributed, the "ARA Scripting Addition"must be accompanied with its documentation files.
Disclaimer
I make no warranties, either express or implied, regarding the fitness of
the "ARA Scripting Addition" for any particular purpose. Use the
"ARA Scripting Addition" at your own risk. The author claims no
liability for data loss or any other problems caused directly or indirectly
by the "ARA Scripting Addition".